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SL-'-DYii  post-processor;  SEADYN  graphics 


..  This  report  describes  the  computer  program  named  SEAPLT, 
which  is  a  graphics  post-processor  to  the  general  purpose  cable 
‘  dynamics  comnuter  model  named  SEADYN.  The  program  is  wri^en 
[with  CALCOMf*' compatability  for  use  with  the  CDC-Cybernet® 
program  UNIPLOT. 
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INTRODUCTION 


This  computer  program  is  written  for  the  purpose  of  plotting  results 
obtained  from  the  SEADYN  computer  program  and  saved  on  restart  files. 
SEAPLT  recognizes  the  following  files  generated  from  SEADYN: 


TAPEl:  DEAD  restart  file 

TAPE2:  LIVE  restart  file 

TAPE3:  DYN  restart  file 

TAPE4:  any  restart  file 

TAPE20;  MODE  output  file 


This  multiplicity  of  input  files  is  provided  to  allow  direct  processing 
of  all  restart  files  created  in  a  SEADYN  run  immediately  following  the 
SEADYN  execution .  ^ 

This  program  is  written  with  CALCOMP  compatibility  in  migd  but 
with  the  intention  of  being  post-processed  on  the  CDC-Cybernet  program 
UNIPLOT.  This  means  that  the  standard  CALCOMP®  calls  will  lead  to  the 
creation  of  a  neutral  picture  file  (NPFILE)  which  may  then  be  processed 
on  any  of  the  devices  supported  by  UNIPLOT. 

SEAPLT  creates  three  general  forms  of  plots;  as  the  present  time 
plotting  is  permitted  from  a  single  restart  file  only.  They  are  geometry, 
functions,  and  cross  plots.  Geometry  plots  display  the  entire  structure 
in  any  of  the  saved  states  viewed  from  any  angle.  They  also  allow 
superimposed  views  of  any  two  of  the  saved  states  or  mode  shapes  plotted 
over  the  reference  state.  Function  plots  produce  graphs  of  the  desired 
parameter  versus  the  appropriate  load  parameter  or  time.  Function  plots 
can  be  generated  only  if  the  restart  file  contains  the  needed  sequence 
of  records.  Multiple  curves  per  graph  are  allowed  if  they  are  of  the 
same  parameter  at  different  points  or  directions  (e.g.,  the  tensions  in 
more  than  one  element  can  be  plotted  on  a  single  graph).  Cross  plots 
represent  the  merging  of  two  function  plots  with  time  or  load  as  a 
parameter.  They  allow  the  plotting  of  such  things  as  element  tension 
versu.s  element  strain  over  a  time  sequence  or  displacement  versus  point 
ioad  v>ver  a  loading  sequence. 

input  is  in  a  free- form  format.  The  following  describes  the 
tasic  free- form  rules. 


FKEL-FJELD  INPUT  RULES 

The  following  special  characters  are  recognized  by  the  subroutine 
FREINP: 

$  Record  Terminator  Flag 

Signals  no  more  data  is  to  be  read  for  the  card  image  being 
processed.  Multiple  card  images  (records)  may  appear  on 
a  single  card  separated  by  record  terminators.  Double 
record  terminators  signal  the  end  of  a  card,  and  any  data 


1 


C0LUMN80 


BLANK 


following  this  is  treated  as  a  comment.  Comments  will  be 
listed  as  part  of  the  card  hut  will  not  be  transmitted  to 
the  data  file. 

Alternate  Record  Terminator  Flag 
Performs  same  function  as  $ 

Default  Record  Te rminator 

Unless  a  prior  termination  or  continuation  is  signalled, 
the  end  of  card  (COL80)  is  taken  as  a  record  termination. 

Word  Deliroitor  (Separator) 

Separates  sequences  of  data  entries  in  a  card  image. 
Repeated  delimiters  produce  zeros  in  the  words.  An  initial 
comma  produces  a  zero  in  the  first  word  of  the  record.  All 
words  not  explicitly  defined  are  assumed  to  be  0.0.  A 
comma  may  be  used  to  signal  multiple  card  records 
(continuation)  when  only  blanks  occur  between  the  last 
comma  and  the  end  of  card. 


Separator/Delimitor 

Leading  blanks  are  ignored.  Once  the  beginning  of  a  word 
is  detected,  a  blank  will  terminate  the  word.  Any  blanks 
following  a  delimiter  are  treated  as  leading  blanks  for 
the  next  word.  The  following  are  equivalent: 


XX  yy 
XX  ,  yy 
XX,  yy 

/  Continuation  Flag 

Signals  a  word  termination  with  the  next  word  to  be  read 
from  the  next  card.  See  for  alternate  continuation. 

W  i  t  i on  Flag 

Use  to  override  the  word  sequencing  and  shift  to  a  new 
word  in  the  record.  Input  t|ien  follows  in  sequence  from 
the  new  word  location.  The  new  word  number  is  given 
infunediately  following  the  W  and  before  the  next  or  blank. 
The  W  may  be  used  as  a  delimiter  of  the  previous  word. 

The  combination  ”,W**  is  the  same  as  W  alone.  The  first 
word  of  a  record  is  not  checked  for  the  W  flag  so 
must  be  used  to  skip  to  a  new  sequence  from  the  first 
word  position.  Any  W  after  the  first  word  and  before 
the  record  terminator  will  be  interpreted  as  a  position 
flag. 

Comment  Card  Flag 

This  character  anywhere  on  a  card  will  terminate  the  record 
and  the  remainder  of  the  card  is  treated  as  a  comnent. 

*  in  column  1  produces  no  record. 

Hollerith  (Alpha-Numeric)  Field  Delimitor 
This  character  is  the  apostrophe  (11*8-5  on  the  026 
keypunch  and  8*5  on  the  029  keypunch).  It  signals  the 
start  and  end  of  a  character  string.  The  string  My  be 
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.uiy  up  to  a  ih.jximiiiii  ol  ihr  luimhrr  ut  lt»a  rliaraiter 

"words"  a i  Lowed  by  I h(’  app 1 1 cat  ion.  Tins  is  usually 
8,  but  it  may  be  iiuue  or  less  as  the  use  dictates. 

Any  legal  character  may  be  used  in  the  string  except  the 
apostrophe.  Character  strings  may  continue  past  column  80 
to  the  next  card  since  the  string  automatically  signals 
continuation  unt i 1  the  terminal  apostrophe  is  found.  A1 1 
blanks  in  the  string  art*  counted  as  characters. 

^  ^^8 i d  F o rma t  Ini  t  i a t o r_  1  1  a^ 

This  in  column  1  of  any  card  after  the  title  cards  signals 
that  the  cards  up  to  the  next  ")"  card  are  in  rigid  format. 
Thest‘  cards  are  written  on  a  special  data  file  in  BCD 
format . 

i  Kj  gid  l’t>rmat  Te*rminalor‘  Kla^ 

Fh  i  .s  1  n  4  ol  umfi  I  s  i  gna  1  s  I  he  end  of  a  sequence  of  rigid 
forma  I  c rds  . 


Any  card  with  a  or  in  column  1  will  be  treated  as  a  comment 

card.  it  will  be  listed  but  will  produce  no  data  record. 

Kach  free-tield  input  deck  is  presumed  to  begin  with  one  or  more 
title  cards.  Title  cards  arc  read  and  listed  until  a  specific  record 
ternuiiatur  is  detected  ($  or  ;  but  not  COLUMNfSO).  The  card  on  which  the 
leniunator  is  detected  will  be  used  as  a  page  heading  for  the  run. 

The  IREINP  subroutine  processes  the  entire  data  deck  and  translates 
all  ot  the  cards  into  a  series  of  data  records.  As  noted  above,  a  data 
icvord  may  span  more  than  one  card  or  there  may  be  one  or  more  records 
on  a  V.  rd .  .After  the  title  cards,  the  data  is  assumed  to  be  arranged  in 
h lucks  headed  by  a  Flag  Record.  Each  flag  record  is  limited  to  ten 
a  I  pha-numer  i  c  cliaracters.  Usually  only  the  first  four  characters  of  the 
Mag  I'etord  have  iiieaiiing.  For  example,  the  flag  record  ELEMENTS  could 
he  slitatened  to  KLKM  to  product'  the  same  result.  The  specific  data 
1*1  de  I  apji(i(abie  t-*  I  he  tlag  recaud  is  tfien  assumed  until  the  next  flag 
IS  delf'i  it'.l.  l  iag  re'ca>rds  must  Inive  the  flag  word  in  the  first 
[uj.siti  ai  (i.e.,  KLKM  will  not  lie  recognized  as  a  flag). 

S.ila  records  are  assumed  to  he  in  floating  point  form  unless  a 
hara<ier  is  detected  which  is  inconsistent  for  a  floating  point  number. 
iJi  this  rase,  the  word  will  be  treated  as  a  Hollerith  word.  All  floating 
puiiii  words  assume  a  decimal  at  the  end  of  the  word  if  none  is  given. 
Words  actually  intended  to  be  integers  are  converted  to  fixed-point  form 
ii  the  Lime  they  are  used.  The  maximum  length  of  a  data  record  is 
determined  by  the  program  using  the  free-field  subroutine. 
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SI.AHi.i  I.M'IT  INSTKUCTfONS 


i’  1 1  If  r.i  r<i  (  s  )  At  I  tMsl  <»iu*  i\m\  »  n  h*  1 1  <•  ti .  Tlie  last  title*  tani  must 
lu’  it'riiu iial (m!  wi(h  .t  4)r  Tlu*sf  l(*rminators  may  not 

appear  anywhert*  rise  m  the*  tilJe  cards.  The  last  title 
card  will  be  used  lor  f)aj§e  headings. 


SELhCT  (flag  record  SEL£) 

Var  i.ible 

Word  Name  Contents 


1  FORM 

J  MAPE 

J  MKEC' 

;  NMODE 

5  LBLCHK 

6  CilKW'KD 


Flutter  Selection  Code 

NARROW  for  10  in.  wide  field  (default) 

WIDE  for  30  in.  wide  field 

File  code  for  RESTART  file. 

tl,  2,  3,  or  4  ...  default  is  1) 

Maximum  number  of  records  on  RESTART  file. 

0  '  no  mode  revjuests  will  be  made. 

^0  -  mode  set  to  be  used  in  overplots. 

Labe  I  check  flag 
0  ^  no  check 

I  -  Make  comparison  of  first  title  word  on  RESTART 
file  and  the  check  word.  Abort  if  they  do  not 
match . 

Wu rd  to  be • used  in  1 abel  check. 


A 


.,y;  ^  r- 


GLi'SETKY  (flag  record  GEOM) 


Wo  rd 
1 


1/ 

8 

t  iuitgf 


\’a  r  1  able 
Name 


Contents 


Ret'erence  record  on  RESTART  file 

i NPl 2 )  Uverplot  record  on  RESrART  file 

INPl  n  Line  type  for  reference  plot  -  SOL  ID”  or  ”DASH” 

(default  IS  ’^SOLID”) 

I  MM  4, 1  Line  type  lor  overplot  (default  is  ”DASH”) 

]NfM8j  t observer  axis  -  tl»  ±2,  or  ±3  (default  =  +1) 

h  I  NP(  1  )  Oljserver  Distance  (default  =  10^^) 

i 1 NP( 2 )  l)i sp id cement  Magnification  (default  =  1.0).  (Displace* 
nient  is  the  difference  between  the  nodal  positions  in 
Liie  two  records .  ) 


ihASh  Bast‘  Vector  Display  Flag 

0  -  plot  labelled  base  vectors  at  origin 
\  -  do  not 


Successive  CEiJM  or  MODE  re^-ords  need  only  words  1  and  2  unless  a 
>  in  parameters  is  desired,  then  only  those  changed  need  be  given, 
fih  jM  foiJowed  by  KOTA  causes  lolated  views. 

<}r*stn'ver  axes  delined  as  1,  2,  3,  for  x,  y,  z,  respect ivelv- 
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MuUh 

Variable 

Wi)rtj  Name  Contents 


6 

7 

H 


INF(l)  Reference  record  on  Ki'STAKT  tile 
1NP(2)  Node  number  on  MODK  file 

JNP(3)  Line  type  for  reference*  plot  -  "SOLID”  or  "DASH” 
(default  is  "SOLID") 

INP(4)  Line  type  for  mode  overpiot  (default  is  "DASH”) 

1NP(5)  Observer  axis  -  tl,  i2,  or  ±3  (default  =  +1) 

FJNP(l)  Observer  Distance  (default  =  10^^) 

KiNP(2)  Node  scale  factor  (default  =  1,0) 

I  BASK  Base  Vector  Display  Flag 

0  -  plot  labelled  base  vectors  at  origin 
1  -  do  not 


Successive  GKON  or  NODL  records  need  only  words  1  and  2  unless  a 
change  in  parameters  is  desired,  then  only  those  changed  need  be  given. 

NODE  tol lowed  by  ROTA  causes  rotated  views. 

The  mode  shapes  are  automatical ly  scaled  to  have  the  largest  component 
value  ur  have  a  magnitude  of  1.0.  The  mode  scale  factor  FINP(2)  should  be 
given  large  enough  to  make  the  mode  shape  distortions  visible. 
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ROTATE 


Variable 

Name 


Contents 


THETA(l)  Rotation  about  global  x  axis  (degrees) 
THETA(2)  Rotation  about  globa 1  y  axis  (degrees) 
THETA(3)  Rotation  about  global  z  axis  (degrees) 


NOTf. :  These  angles  are  sequential  x  ^  y  +  2.  A  rotation  about  x  followed 

by  y  means  that  y  rotation  is  about  the  new  orientation  of  the  y  axis 
after  the  x  rotation. 

It  a  rotation  about  y  is  desired  before  a  rotation  about  x,  then 
use  two  rotation  records: 

KOTA 

0,  e  ,  0 

6  ,  8,  0 

x’  ’ 

Afjy  number  of  rotation  records  may  be  given  and  they  will  all  be 
sequential  relative  to  the  last  rotation  executed. 

All  rotations  follow  the  right-hand  rule  relative  to  the  last 
defined  position  of  the  axes. 

The  default  view  will  show  the  y-z  plane  (see  1NP(5)  of  the 
ciEuM  record). 


i  A  one  card  title  for  the  plot.  H  used,  this  roust  be  input  as  a 
up  character  string  which  begins  and  ends  with  an  apostrophe  (*). 
to  8 


VIEW  causes  the  results  of  a  string  of  rotations  to  be  plotted- 
V'lEW  followed  by  ROTA  records  continues  the  rotations  relative  to 
the  last  position. 

Any  record  flag  except  ROTA  or  VIEW  following  a  GEOM  or  MODE  record 
will  cause  the  current  view  to  be  plotted  with  a  default  heading  (i.e.,  the 
VIEW  record  is  not  required). 
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FLNCTION 


Variable 
Word  Name 


Contents 


1  Vl'ODE 
C  jNCU) 

i  iNPU^ ) 

JNFCn 
\HhG 
b  NLIM 
INCH 
X1\CH 

^  loPI 

i  hEb 


Function  Code  (see  CoiJh  list) 

Curve  code  lor  liist  ciirve  (solid  line)  (see  Note  below) 
Curve  code  ior  second  curve  (dashed  line)  (see  Note  below) 
Curve  code  lor  third  curve  (dotted  line)  (see  Note  below) 
Bt  >!  r  nn  i  ng  record  on  RFbTAHT  lile  (default  =  1) 

Kudin^  record  on  KFSTAKT  tile  (default  -  last  one) 

Record  me  rt‘menl  (  de  t  au  1 1  -  1  ) 

H«M  izonlai  Plot  l.en^lfi  (default  =  6  for  NARK;  10  for 
W  I  UK  ) 

Curve  K}\)i  1  v»n 

U  -  strai>;ht  1  i  rtes  between  poiirts 
1  -  s|)  i  i  ne  t  i  I 

Plwi  title  UJse  charoctei'  str  in)t>  '  '  )  max  i  mum  of  bO 

c  na  ra c  1 1‘  r  s 


til  r  i/ont  il  Scalr‘  will  show: 


i  .  m*  t  (U'  I  >VN  tile* 

'  id  1  ac  t  or  V (»  to  I  .  0  )  1  or 


L  >ad  factor  for' 

St^-p  Numb^M  tor 

He. 1.1 1  ng  for 

;  I  me  1  (>  r 


DKAI)  file 

L 1 VK  file  ( nci  rma  1 1  y  ) 

L I  VK  \’  [  SHKK  solution 
LiVK  when  flEDlNC  *  0 
L  i  \1.  with  r  i  im‘  Seqiiencaai  Static 
So  1  U  t  1  I  'IIS 


■.  V  le;> 


*  .emt  ut  Hat  i  -  element  number 


t  '  *  {.  o*la  i  <K-i  t  a 


-  Packed  word  (10  times  node  number 
numt>et  ,  t‘ .  g .  ,  2.]2  means  rujde  y 


plus  direction 
d i rec 1 1  on  ) 


i 

! 
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CRuSS 

Vcjri.ible 

Uoiti  Name  CcMitents 

1  HCODE  Horizontal  1  unci  ion  c  (see  CODE  list  below) 

2  JNFl  1  )  Horizontal  turv/e  code*  (see  Note  2  under  FUNC  record) 

i  VCODK  Vertical  iunction  code  (see  CODE  list  below) 

4  JNP(2j  Vertical  curve  code  (see  Note  2  under  FUNC  record) 

NHEC  Be^^inning  record  on  RESTART  file  (default  =  1) 

b  NLIM  Ending  record  on  RESTART  file  (default  =  last  one) 

7  INCk  Record  Increment  (default  =  1) 

8  XINCH  Hotizonlal  Plot  Length  (default  -  6  for  NARH;  10  tor 

W  1 1>K  ) 

4  I(*Pr  Cur  ve  Up t  ion 

0  -  St  raight  line  between  points 
I  -  sp 1  I  no  t  1 1 

id  PLTHhD  1‘lot  Title  (use  character  string  '  ')  maximum  of  60 

ha  rat  t  ers 

i  Ul.^  I  .  I  .J!  t  ud»*S 

I’i  S  No<la  J  pos  I  I  1  on 

.*>1  Nodal  d  1  s[>  1  a  cement  from  position  in  first  record 

ids  Nodal  displacement  Iunction  for  current  position 

\K1,  Nodal  velocity 

\M.  \(»da  i  a  I A  c  1  e  I  a  t  ion 

1  i'.N  1. 1  enitUil  l  f*ie>  i  on 

S  I  h  L  i  ►'iiien t  ^  i  I  .j  1  n 

n:  N  h.  Iriiienl  ierikitii  Current  j 

i.N>‘)  KlciiK*nl  It'iigLli  (  uns I  n* I  (  hed  j 

INN  Piemen I  reference  terns  ion 

ruK  Nodal  total  torce 

Mik  Nvjdal  gravity  force 

PPl  Nuda 1  point  load 

/  Id  Soda  1  fluid  1  Odd 

VT  L  Nod a i  fluid  velocity 
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END 


(no  data  record) 

Terminates  data  set  and  closes  plot  file. 
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